home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / aspgue1a / readme.txt < prev    next >
Encoding:
Text File  |  1999-09-22  |  6.5 KB  |  138 lines
  1. Guestbook by Kathi O'Shea
  2. http://www.attitude.com/users/kathi/asp (ASP Tutorial Site)
  3. http://www.web-savant.com (business site)
  4. kathi@attitude.com (support & comments)
  5. info@web-savant.com (design and customization)
  6.  
  7. Guestbook Instructions
  8.  
  9. IMPORTANT!! This guestbook will only work on an ASP-enabled site,
  10. and you must have script permissions on the directory where the
  11. ASP scripts are located. This script will not work on GeoCities,
  12. AOL, or most (if not all) of the free homepage sites. If you're
  13. not sure if your site is ASP-enabled, contact your system administrator.
  14.  
  15.  
  16. Contents:
  17.  
  18. 1. Files contained in this distribution
  19. 2. Copyright information and Disclaimer
  20. 3. Modifying scripts
  21. 4. How to set up a system DSN
  22. 5. The CDO (Email) Module - Comments & Config
  23. 6. Revision History
  24. ----------------------------------------
  25.  
  26. 1. Files contained in this distribution
  27.  
  28. README.TXT (this file)
  29. Guestbook.mdb
  30. sign.asp
  31. administration.asp
  32. default.asp
  33.  
  34. -----------------------------------------
  35.  
  36. 2. Copyright information & Disclaimer
  37. Scripts, html and sample database template copyright 1998, Kathi O'Shea.
  38. All files can be freely modified as long as the copyright
  39. information on each script and html file remains intact.
  40. You may also redistribute the zip file, as long as all of the
  41. original distribution files are left intact and unmodified.
  42.  
  43. I also ask that if you implement the guestbook on your site that
  44. you email me the URL, so I can see it in action. Also, please
  45. let me know if its ok to include a link to your site in future
  46. versions of my page. 
  47.  
  48. DISCLAIMER: This program is freeware, and as such, carries no guarantees
  49. or warranties. While great care has been taken to test it to ensure that
  50. it works properly, there may be unforeseen problems under unusual circumstances.
  51. I do also not guarantee that I'll be able to offer technical support. I will, 
  52. however, try to give free limited support, and to address any unforeseen
  53. problems as they arise. I will also be happy to customize the guestbook to your
  54. needs (add fields, images, custom colors and/or layout, etc) needs on a fee basis.
  55.  
  56. -----------------------------------------
  57.  
  58. 3. Modifying scripts
  59. There are certain modifications to the scripts that you may want
  60. to make. I have provided comments in the script pointing out areas
  61. where customization might be desirable. For example, the ASP scripts 
  62. now all use dsn-less connections to the database. If you do not locate 
  63. your database at the server root, you will need to change the path
  64. to the database. For example, if I have my database file located in the
  65. /guestbook/ directory under our webserver root, I would need to change it to
  66. server.mappath("/guestbook/guestbook.mdb") in my working script.
  67.  
  68. If you prefer to use a system DSN, uncomment the appropriate line for the 
  69. DSN and take out the dsn-less code (comments are provided in the scripts
  70. to show you what to do). The DSN line would look like conn.open "guestbook".
  71.  
  72. Of course, the html code can be customized with your choice of colors
  73. and fonts, font size, images, etc. Just be careful when changing code
  74. in response.write strings - remember that you have to use single quotes
  75. within the response.write string (starting and ending the string
  76. with double-quotes, of course) or the script will bomb. 
  77.  
  78. This set of scripts was created in a single directory, so if
  79. you plan to put the ASP scripts in a separate directory, please
  80. be sure to change all the pointers to the ASP scripts to the
  81. appropriate directory. 
  82.  
  83. -----------------------------------------
  84.  
  85. 4. How to set up a system DSN
  86. If you plan to use ASP to access a database, you will want to set
  87. up a DSN (Data Source Name) for each database you'll use. If you
  88. plan to try out some of the sample database scripts from this site,
  89. you will need to set this up before trying any of the scripts. 
  90.  
  91. Setting up the DSN is a simple process. Simply double-click the
  92. ODBC applet in the Control Panel, choose the System DSN tab, and
  93. click Add. Choose the type of database driver you'll be working
  94. with - the sample database from this site is MS Access - then
  95. click finish. You'll then need to type in the database name in
  96. the Data Source Name box, and click Select. Next you'll navigate
  97. to the drive and directory where the database is located, click
  98. on the file name and click OK on that window and the one behind it.
  99. Now you can refer to the database by name in your scripts and the
  100. system will know which ODBC driver to use and where the database
  101. is located. 
  102.  
  103. -----------------------------------------
  104.  
  105. 5. The CDO (Email) Module
  106. If your server CDONTS installed (the built-in SMTP for NT that's 
  107. installed by default with Option Pack 4), the script now has the
  108. capability to email new guestbook entries to you as they're entered.
  109. IMPORTANT: You will get an error when you try to sign the guestbook
  110. if the server doesn't have CDONTS available. If this happens, either
  111. remove the email block of code or modify it to use a server component,
  112. if available. Sample code for ASP QMail is available on my site at
  113. http://www.attitude.com/users/kathi/asp/samples/tut/ASP_QMail.asp if
  114. your web host happens to use that particular component. 
  115.  
  116. CONFIGURING the CDO PORTION OF SCRIPT (IMPORTANT!)
  117. If you find that you do have CDONTS available to you, great! You will 
  118. need to make a couple of minor changes to the script. All this entails 
  119. is putting your OWN email address in where I've supplied a default email -
  120. in other words, replace info@web-savant.com with YOUR email address, and
  121. replace you@yourdomain.com with YOUR email address. That's all that needs
  122. to be changed - it should work just fine if the server has CDONTS going.
  123.  
  124.  
  125. -----------------------------------------
  126.  
  127. 6. Revision History
  128. 09/22/99 - Renamed Date field in guestbook table to PostDate
  129. 09/22/99 - Finally! The admin script displays the newest entries first!
  130. 05/22/99 - Added CDO email notification to script
  131. 04/12/99 - Finally added multiple deletes to the administration script! :)
  132. 01/09/99 - Finally got around to adding paged records and navigation between pages!
  133. 01/09/99 - Updated the readme.txt file to reflect changes in DSN and DSN-less info.
  134. 12/94/98 - Added bug fix caused by previous bug fix that broke Comments field validation.
  135. 12/02/98 - Added bug fix caused by double-quotes in form fields
  136. 12/02/98 - Added DSN-less connection capabilities to scripts
  137. 11/01/98 - Combined individual administration scripts into single script
  138. 10/28/98 - First version of the scripts and database created.